께께께께께께께께께께� 께 께같 께 LISTER.EXE 께같 께 께같 께께께께께께께께께께껐� 같같같같같같같같같같� Shareware-Version 3.3 Listingoptimierer f걊 dBASE-Programmcode LISTER.EXE Seite 1 컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴 K U R Z A N L E I T U N G Das Utility LISTER.EXE liest dBASE - Quellcodedateien und bereitet ihre Form etwas auf: - alle Leerzeilen werden entfernt, - alle f갿renden Leerzeichen und Tabulatoren werden entfernt, Schleifen und Bedingungen durch Leerzeichen einger갷kt, - logische Werte und Konjunktionen (.T., .F., .AND., .OR., .NOT.) werden in Gro�buchstaben umgewandelt, davor und danach ein Leerzeichen einge- f갾t, - vor und nach den vier Rechensymbolen (+, -, *, /) und dem Gleichheits- zeichen wird ein Leerzeichen eingef갾t, falls es nicht schon vorhanden ist, - nach einem Komma und der schlie�enden Klammer wird ein Leerzeichen ein- gef갾t, - wahlweise fortlaufende Zeilennummern, - wahlweise optische Hervorhebung von Schleifen und Bedingungen, - alle Befehle und Variablen werden in Kleinbuchstaben umgewandelt, k봭nen jedoch wahlweise in Gro�buchstaben ausgegeben werden, - Kommentare in Befehlszeilen ("&&") auf Fluchtlinie. - Kommentarzeilen, die mit einem Asterisk "*" beginnen, werden unver- 꼗dert 갶ernommen, - Programmzeilen zwischen den Befehlen TEXT ... ENDTEXT werden unver- 꼗dert 갶ernommen. - Programmzeilen, die mit dem Befehl RUN beginnen, werden unver꼗dert 갶ernommen. - Wahlweise kann die aktuelle Version vor die Datei geschrieben werden. - Wahlweise kann ein Vorspann vor die Datei geschrieben werden. Das Programm erstellt eine ASCII-Datei, die den aufbereiteten Quellcode ent- h꼕t. Gleichzeitig k봭nen Sie den Text wahlweise auf den Bildschirm und/oder Drucker ausgeben lassen. Wenn Sie bereits w꼑rend der Programmierung Ihren Quellcode ausf갿rlich dokumentieren, erhalten Sie damit eine komplette Pro- grammbeschreibung mit s꼖tlichen Informationen 갶er das Programm. LISTER.EXE Seite 2 컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴 INSTALLATION: Auf der Diskette sollten Sie folgende Dateien finden: BESTELL.TXT - Bestellformular f걊 Vollversion DBCOMP.PRG - dBASE IV-Quellcode zur Demonstration DBCOMP.ASC - mit LISTER bearbeitete Datei DBCOMP.DBF - wird f걊 DBCOMP.PRG ben봳igt HANDBUCH.TXT - Bedienungsanleitung LISTER.EXE - Programm DSINFO.TXT - Informationen zur DS Kopieren Sie die Datei LISTER.EXE in ein beliebiges Unterverzeichnis der Fest- platte, auf das ein Pfad gelegt wurde (z. B. PATH = C:\DOS). BEDIENUNG: Das Programm unterscheidet zwischen dem interaktiven und dem Batchmodus. Im interaktiven Modus k봭nen Sie erforderliche Einstellungen selbst vornehmen, im Batchmodus l꼞ft das Programm v봪lig selbst꼗dig und eignet sich deshalb f걊 den Aufruf aus Batchdateien. 1. Starten Sie das Programm vom aktuellen Laufwerk oder Unterverzeichnis mit dem Aufruf C:> LISTER [/A | /B | /?] Beim Aufruf ohne erhalten Sie darauf eine Auswahl aller vor- handenen Dateien mit der Endung .PRG . W꼑len Sie die zutreffende Datei mit dem Leuchtbalken aus. Mit den Tasten "Page Down" und "Page Up" k봭nen Sie in der Auswahl bl꼝- tern. Mit dem Parameter /A starten Sie den Batchmodus f걊 ASCII-Dateien. Sie er- halten eine Datei mit der Endung .ASC, die Zeilennummern und die grafische Aufbereitung der Schleifen und Bedingungen enth꼕t. Die evtl. vorhandene Version wird nicht ge꼗dert. Mit dem Parameter /B starten Sie den Batchmodus f걊 PRG-Dateien. Die vor- handene Quellcode-Datei wird in .BAK umbenannt. Sie erhalten eine Datei mit der Endung .PRG, die nur den aufbereiteten Quellcode enth꼕t (keine Zeilennummern und grafische Aufbereitung der Schleifen und Bedingungen). Die Version wird entweder eingef갾t oder ge꼗dert. Diese Datei k봭nen Sie problemlos unter dBASE oder CLIPPER einsetzen. Mit dem Parameter /? wird ein Hilfebildschirm ausgegeben. Ohne die Parameter /A und /B startet das Programm im interaktiven Modus. Hier k봭nen Sie die Einstellungen selbst vornehmen. LISTER.EXE Seite 3 컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴 2. Im interaktiven Modus erhalten Sie als n꼊hstes die Eingabemaske. Hier k봭nen Sie folgende Einstellungen vornehmen: - Programmname ist der Name Ihrer dBASE - Quellcodedatei (Endung immer .PRG) - Textdatei ist der Name der ASCII-Datei, die erstellt wird (Endung immer .ASC) - Version ausgeben geben Sie hier ein "J" ein, wird die aktuelle Versionsnummer des Quell- codes ausgegeben - Gro�buchstaben geben Sie hier ein "J" ein, wird der Quellcode in Gro�buchstaben ausge- geben - Linker Rand ist der linke Rand des Ausdrucks (nur auf Drucker wirksam) - Zeilen je Seite ist die Anzahl der Zeilen des Ausdrucks (nur auf Drucker wirksam) - Zeilennummern schaltet die Ausgabe von Zeilennummern ein oder aus - Grafik schaltet die Hervorhebung von Schleifen und Bedingungen durch Grafikzei- chen ein oder aus - Vorspann gibt einige Kommentarzeilen aus. Hier k봭nen Sie anschlie�end Beschrei- bungen zum Programm eintragen. Die in der Datei enthaltenen Prozeduren und Funktionen werden automatisch ermittelt und aufgef갿rt. - An Drucker der erstellte ASCII-Text wird sofort an den Drucker gesandt. Schalten Sie den Drucker zweckm꾞igerweise auf einen kleinen Zeichen- abstand. Der Ausdruck wird dadurch 갶ersichtlicher. - An Bildschirm der erstellte ASCII-Text wird auf dem Bildschirm ausgegeben Das Programm erstellt dann im aktuellen Laufwerk oder Unterverzeichnis die ASCII-Datei und gibt den Text wahlweise auf den Drucker und/oder den Bild- schirm aus. LISTER.EXE Seite 4 컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴 !!! WICHTIG !!! - Das Programm legt w꼑rend des Ablaufs einige tempor꼛e Dateien an, deren Gr붳e von der L꼗ge des Quellcodes abh꼗gt. Sie k봭nen diese Dateien durch Setzen der Umgebungsvariablen TEMP auf ein beliebiges Laufwerk (z. B. RAM-Disk) umleiten. Geben Sie dazu im Betriebssystem z. B. ein: SET TEMP=D:\ - Die gr붳te Zeilennummer, die das Programm vergeben kann, ist 99.999. Ist Ihr Quellcode l꼗ger, m걌sen Sie die Zeilennummern in der ASCII- Datei nachtr꼏lich 꼗dern. - Das Programm kann nur Zeilen mit einer maximalen L꼗ge von 256 Zeichen bearbeiten. Enth꼕t Ihr Quellcode l꼗gere Zeilen, sollten Sie vor der Bearbeitung die Zeilen durch das Semikolon ";" trennen. - Das Programm erwartet, da� Sie den Quellcode ausschreiben (nicht nur 4 Buchstaben). Au�erdem sollten Sie auf Kommentare "&&" in Befehlszeilen, die nachfolgende Schl걌selw봱ter enthalten, verzichten. Dies kann bei der optischen Aufbereitung der Schleifen und Bedingungen zu Fehlern f갿ren. - Das Programm erkennt folgende Schleifen und Bedingungen: o IF ... ELSE ... ENDIF o DO CASE ... CASE ... OTHERWISE ... ENDCASE o DO WHILE ... ENDDO o FOR ... NEXT o SCAN ... ENDSCAN o PRINTJOB ... ENDPRINTJOB o BEGIN TRANSACTION ... END TRANSACTION o TEXT ... ENDTEXT - Das Programm arbeitet am schnellsten im Batchmodus, da die gleichzeitige Bildschirm- und/oder Druckausgabe den Ablauf bremsen. LISTER.EXE Seite 5 컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴 COPYRIGHT: LISTER ist ein durch das Urheberrechtsschutzgesetz gesch걎ztes Programm. Sie finden auf dieser Diskette eine voll funktionst갷htige Pr갽version. Diese Shareware-/Pr갽version darf sowohl kommerziell wie privat beliebig kopiert und verteilt werden. Nur durch Ihre Mithilfe bei der Werbung und durch den Direktvertrieb k봭nen Shareware-Produkte sehr preiswert ange- boten werden. Bitte zahlen Sie bei regelm꾞iger Benutzung dieses Programms die Lizenz- geb갿r von 50 DM. Sie erhalten dann die neueste Vollversion. Mit Ihrer finanziellen Unterst걎zung von Shareware-Autoren f봱dern Sie die Entwik- klung preiswerter Software. Einen Bestellschein finden Sie in der Datei BESTELL.TXT. Ich 갶ernehme keinerlei Haftung f걊 Sch꼋en an Rechnern oder Datenverluste aus dem Gebrauch von LISTER. Falls Sie Tips oder Verbesserungsvorschl꼏e zu LISTER haben, teilen Sie sie mir bitte mit. Vielen Dank im voraus f걊 Ihre Unterst걎zung. Erlangen, 1. Juni 1993 Bernd Hohenester Aschaffenburger Stra�e 16 D-91056 Erlangen Tel.: (09131) 4 87 88